大盘解析列表

接口描述

通过代币（BTC/ETH）查询AI大盘解析的历史记录，支持时间范围过滤。

使用场景：

• 适用于按代币 ID 精确查询历史大盘分析记录
• 适用于图表渲染等批量获取场景
• 适用于了解特定代币的 AI 综合信号与压力支撑结论

数据更新频率：每5分钟更新一次

请求URL

• 方法：POST
• 路径：/open/v1/ai/getMarketAnalysisList

积分消耗

• 消耗积分：3

前置条件

需要 vsTokenId，可通过 代币列表 接口获取。

请求参数

参数通过请求体（Body）以 JSON 格式传递。

参数名	类型	必需	描述
vsTokenId	long	是	代币 ID
beginTime	string	否	开始时间（毫秒时间戳）
endTime	string	否	结束时间（毫秒时间戳），不传默认当前时间
limit	integer	否	返回数量，默认 200，范围 1-2000
language	string	否	语言，支持 zh-CN / zh-TW / en-US / vi-VN，默认 zh-CN

响应字段

仅展示 data 数组内每个对象的字段结构：

字段	类型	实际返回类型	描述
vsTokenId	long	string	代币 ID
symbol	string	string	代币符号
icon	string	string	代币图标 URL
price	number	string	分析时价格
signal	string	string	AI 综合信号（如：HOLD / BUY / SELL）
klineDiff	number	string	K 线涨跌幅（小数，如 -0.003 表示 -0.3%）
supports	array	array<string>	支撑位价格列表（价格字符串）
resistances	array	array<string>	压力位价格列表（价格字符串）
analysis	string	string	AI 分析结论（请求语言版本）
analysisTime	long	long	分析时间（毫秒时间戳）

字段业务含义

字段	业务含义	使用建议
vsTokenId	代币唯一标识	与请求参数对应，用于数据归属校验
symbol	代币交易符号（如 BTC、ETH）	用于 UI 展示
icon	代币图标 URL	用于前端渲染
price	本条分析发布时的代币价格	与 analysis 配合理解价格背景
signal	AI 综合方向信号（如：HOLD / BUY / SELL）	快速判断 AI 整体倾向
klineDiff	K 线变动幅度（小数，正值为涨，负值为跌）	与 signal 配合判断价格动能
supports	AI 计算出的关键支撑价格列表	关注最近支撑位，辅助止损
resistances	AI 计算出的关键压力价格列表	关注最近压力位，辅助止盈
analysis	按请求语言返回的 AI 综合分析结论（string）	直接展示给用户，无需客户端再做语言分支处理
analysisTime	分析记录的时间戳	用于按时间排序和展示

请求示例

{
    "vsTokenId": 1,                 // 代币 ID
    "beginTime": "1775732440000",   // 开始时间
    "endTime": "1775734240000",     // 结束时间
    "limit": 200,                   // 返回数量
    "language": "zh-CN"             // 语言（可选，默认 zh-CN）
}

cURL 示例（Linux/macOS）

curl --location --request POST 'http://${host}/api/open/v1/ai/getMarketAnalysisList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "beginTime": "1775732440000",
    "endTime": "1775734240000",
    "limit": 200,
    "language": "zh-CN"
}'

cURL 示例（Windows CMD）

curl --location --request POST "http://${host}/api/open/v1/ai/getMarketAnalysisList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"beginTime\": \"1775732440000\",    \"endTime\": \"1775734240000\",    \"limit\": 200,    \"language\": \"zh-CN\"}"

成功响应示例

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",                                            // 代币 ID
            "symbol": "BTC",                                             // 代币符号
            "icon": "https://static.valuescan.io/valuescan/cmc/coins/1.png", // 代币图标 URL
            "price": "80573.75",                                         // 分析时价格
            "signal": "HOLD",                                            // AI 综合信号
            "klineDiff": "-0.00298373",                                  // K 线涨跌幅（小数）
            "supports": ["80434.275", "79980.475"],                      // 支撑位价格列表
            "resistances": ["80776.78", "81208.86"],                     // 压力位价格列表
            "analysis": "📊 BTC 日内主力资金趋势分析(ValueScan)...",     // AI 分析结论（当前语言版本）
            "analysisTime": 1778837430000                                // 分析时间
        }
    ],
    "requestId": "2055219406232641536"
}